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(1.1) INTRODUCTION 



Welcome to the ADVENTURE CREATOR! 



This manual is intended as a simple introduction to the writing of 
adventures using AC. The ADVENTURE CREATOR is best thought of as a 
small programming language specifically designed for the writing of 
adventure games. Although it is smaller than other programming 
languages such as Basic or Pascal, it can perform all of the 
complex tasks needed to write an adventure program; and although 
the instructions may seem a little complicated at first, a little 
time spent studying this manual will enable you to write your very 
own large scale adventures, far more easily and efficiently than in 
basic or machine code. 

Although the Adventure Creator was written with the Electron 
in mind, it may also be run on the BBC, (including the BBC Plus and 
Master). When this is done an extra 7000 bytes are available for 
the adventure, (since it will automatically use a mode 7 screen). 
The resulting (runnable) adventure will still run on the Electron, 
since it reclaims the memory used by the editor. 

The datafiles created by AC are compatible with those of the 
Graphic Adventure Creator, so long as the memory limitations of 
either are not exceeded. 

Hence an adventure created on the Electron may be transferred to 
GAC and have pictures added to run on the BBC. The only exceptions 
are the conditions 1 CHN 1 which is ignored by GAC, and * TEXT 1 and 
'PICT' which are ignored by AC. 

Any adventures that you write using AC are your own work, and 
may be sold as such without any prior permission being sought or 
payment to us being made. However in this case, you should include 
with your adventure something to the effect that it was written 
using the ADVENTURE CREATOR, (C) 1986 by Sean Ellis/Incentive 
Software . 

And now on with AC ! 
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(1.2) LOADING INSTRUCTIONS 



The Adventure Creator, (AC), files supplied are as follows: 

"AC M THE ADVENTURE CREATOR - See section 2 

2. "QS" The Quickstart File 

3. " ADVMAN " The Adventure in the Manual 

4. "RANSOM" A Demonstration Adventure 



Loading 

To load "AC" type CHAIN "AC" (return) 

To load "RANSOM" type CHAIN "RANSOM" (return) 

To load "QS" AND "ADVMAN " see below 



"QS " and "ADVMAN " 



Files "QS" and "ADVMAN " can be loaded by selecting T from the main 
menu in "AC". 

QS - Quickstart, sets you up with the most commonly used verbs etc 
and common messages. A complete listing of its contents is 
contained in Appendix B, along with several other useful tables and 
charts . 

ADVMAN - Sets up the small adventure in the manual to work through 
and even edit! (See Appendix A) 



(2.1) SECTION TWO - WRITING ADVENTURES 



There are several elements necessary to the writing of 
adventures using AC. These are displayed on the Main Menu which is 
the first thing you will see after loading up. 

For convenience, the menu is arranged in alphabetical order, 
to make it easier for you to remember which keys to press, to call 
up any part of AC. 

You may write the elements of your adventure in any order you 
like, although you may find that some orders may make things easier 
than others. 

What follows is a brief description of what each element of the 
main menu does, and detailed instructions of how to enter each one, 
in an order that you might choose to enter them. 



(2.2) VERBS 



Verbs are the words with which you will actually tell the computer 
what to do when you are playing an adventure. For example EAT or 
DROP. Directions such as WEST or UP are also included. AC allows 
you to enter and edit your own verbs when writing an adventure. 
Some of the most commonly used verbs are already in the Quickstart 
File; however since AC allows you to enter up to 255 verbs, your 
imagination is the only limit to the commands you can give your 
adventure . 

After pressing V'On the Main Menu, you should see a prompt on 
the screen *EDIT VERBS* and a pointer >. 

To enter a verb, simply type in a number then a space followed 
by your verb. When you press RETURN, the verb will be entered on the 
screen in alphabetical order. 

If two or more verbs have the same meaning and you wish both to be 
accepted ie. "Get" and "Take", simply allocate them the same verb 
number. Try to think of as many similar words as you can in this 
way, as this will make your adventure more friendly. 

To edit a verb you can do one of two things. If you press 
RETURN, this frees a small cursor which can be directed by means of 
the arrow keys to the verb you wish to edit. Characters may then be 
copied by use of the COPY key to the editing line at the bottom and 
changed. More simply perhaps, the offending verb can simply be 
retyped and entered in the normal way. The arrow keys may then be 
used to move the pointer to the previous version for deletion, using 
DELETE. If you have deleted a verb by mistake, COPY will retrieve 
the last word deleted. 

There is a brief summary of these instructions at the bottom of 
the screen. 

More information about the use of verbs may be found in section 
(2.7) CONDITIONS. 



PRESSING ESCAPE WILL RETURN YOU TO THE MAIN MENU 



(2.3) ROOM DESCRIPTIONS 



The term room can be used to refer to any location in your 
adventure. For example, "a forest" , "a car" , "a strange alien 
world" and so on. AC allows you, memory permitting, to use up to 
9999 of these rooms, and to specify the connections to and from each 
room. You will probably find it easier if you have decided in 
advance, what each room is and how they are connected. 

On pressing R on the main menu, the prompt WHICH ROOM NO? should 
appear. At this point you can either, enter a room number followed 
by RETURN which will give the prompt ROOM NUMBER # IS. . . ,or you 
can simply press RETURN which will give the same prompt, but 
stepping through each time you do it, from number 1. You should 
then either, enter your description which can be up to 255 
characters followed by RETURN, or simply press RETURN if there is 
no description. 

You will then see the prompt CONNECTIONS ARE? These connections 
are specified in terms of a VERB , which must be from the list 
already specified, followed by a space, followed by the room number 
it connects with. For example EAST 20 

You may have as many connections from a single room as you can 
fit into 255 characters, all on a single line and followed by 
RETURN. ie. EAST 20 WEST 18 NORTH 19 SOUTH 21 JUMP 49 (Return) 

All of the above may be edited at any time by using the arrow 
keys to separate the cursors, and moving the smaller one to the part 
to be edited. The COPY key copies characters to the editing line at 
the bottom of the screen, where they may be edited in the usual way. 
RETURN enters the edited version. Pressing fO will delete the 
entire entry for that particular room. ESCAPE at any point will 
return you to the WHICH ROOM NO? prompt, and ESCAPE at that point 
will return you to the main menu. 



(2.4) MESSAGES 



Messages are the pieces of information, prompts and so on, that 
appear on the screen when you play an adventure. For example WHAT 
NOW?, or YOU CAN'T DO THAT. Many of the most common system 
messages, numbers 238 to 255, such as these are contained in the 
Quickstart file. AC allows you to enter up to 255 messages that 
can appear at any point in your adventure. 

When you press M on the Main Menu, the prompt asking for a 
message number will appear. You should then enter a number followed 
by your message, this may be up to 255 characters long. Pressing 
RETURN will enter your message and prompt for the next message 
number'. 

To edit a message once it has been entered, simply recall the 
message and edit it in the usual way, (refer 2.3 Room Descriptions). 

Please note that messages 238 to 255 should all be defined, 
since these are essential system messages without which, your 
adventure will not run. You can edit these messages, but you should 
be careful to preserve the meaning. For example, message 242 
PARDON? could be changed to YOU WHAT? (All these messages are set 
up in the Quickstart file). 

Pressing ESCAPE will return you to the prompt EDIT MESSAGE? and 
ESCAPE from there will return you to the Main Menu. 



(2.5) NOUNS AND OBJECTS 



Nouns are the "things" that your adventure will recognise. For 
example BOOK, SWOr! and so on. You should not be too confuje by 
the fac that AC frequently requires you to define *W J»* « 

■ust be defined a/a noun, and you oust also define two objects, AN 

UNLIT LAMP and A LIT LAMP . *ut>tt NOUNS* 

When vou press N on the main menu, the prompt *EDIT nouns* 
will appear Apart from this. the procedure for enter ng and 
el ting nouns is exactly the same as that for editing verbs. (2.2) 

When you press 0 on the main menu, the prompt WHICH OBJECT 

NUMBER? will appear. followed by 

You should then enter a number from L to 255 followed by 
RETURN. You will then see the prompt OBJECT # ^- ■ ■ ■ ■ 
You can then enter the object description of up to 255 characters 
followed by RETURN. This will produce the prompt "Starts n roo ^ 
J° " the i OC ation number of the room you wish this object to start 
off in! The C prompt asking for the weight will ^RETURN 
the weight you wish to allocate to this object and press RETURN. 

If The start room number remains at zero, the object ^assigned 
to ROOM ZERO I a special room which cannot be travelled to which 
contains ^dead" and "unborn" objects. For example, a piece of cake 
once eaten will be assigned to room zero. 

ESCAPE will return you to the main menu. 

More information about the use of nouns and objects can be found in 
section (2.7) CONDITIONS. 



(2.G) ADVERBS 



In AC adverbs are used for two sorts of things Firstly to describe 
the precise way a verb is used. For example, MOVE SLOULY or PUT down 

^Secondly they are used to differentiate between similar nouns. 
For example if your adventure has three differently coloured boxes, 
lie adverbs will specify the colours RED, GREEN etcet 

On pressing A on the main menu, the prompt *EDIT ADVERBS* will 
appear Apart from this the procedure for entering and editing 
adverbs ifexactly the same as that for editing verbs and nouns. 



Hore information on the use of adverbs can be found in section 
(2.7) CONDITIONS. 



(2.7) CONDITIONS 



When using AC the conditions form the internal commands that 
simulate decision making processes within the game. 

All the terms you have specified and the data you have entered 
is now drawn together to form the structure of your adventure. 

Conditions tell the adventure that if certain conditions are 
met, then it is to do something. i.e. "If x is true then do y". 
Or you can build up conditions to a more complex level, 
i.e. "If x and y are true then do t", 

or "If z and q are true then do y and x", and so on. 

AC has a special format for writing these conditions. For 
example, if you have defined a verb number sixteen to mean "Examine" 
and a noun number 2 to mean "Room", then a condition using these 
terms might read : 

"IF ( VERB 16 AND NOUN 2 ) LOOK WAIT END" 
Translated this means if 'Examine Room* is typed in, describe the 
current room and wait for a new command. 

The Conditional list below separates the words used for the 
"Conditions Part" e.g. If (Verb 16 and Noun 2 ) and those used for 
the "Action Part" after the first close bracket), i.e. LOOK WAIT END 
Subscripts used (a, c, m, ms , o, n, r, v, x and y) - See Appendix B. 



CONDITION PART 



VERB v 



NOUN n 
ADVE a 



Is verb v typed ? (v is a number) 
VERB 7 will give a TRUE answer if verb number 
7 was typed, otherwise it will give a false 
answer . 

Is noun n typed ? (similar to VERB) 
Is adverb a typed ? (similar to VERB) 



HERE o 



CARR o 
AVAI o 



r IN o 



WEIG o 



Is object o here ? (i.e. in the same room as 
you ?) 

If you are in room 3 and object 1 is also in room 
3 , then HERE 1 will give a TRUE answer because 
object 1 is here. 
Is object o being carried ? 

Is object o available for use (i.e. here or being 
carr ied ) 

Is object o in room r ? If object 1 is in room 3, 
as above, then 1 IN 3 will be TRUE, but 1 IN 4 
will be FALSE. 

Gets the weight of object o. In our adventure, 
WEIG 2 would give the value 20, which is the 
weight of the rat. 



SET? m Is marker m set ? 

RES? m Is marker m reset ? 

(There are 256 markers, numbered 0 to 255. They 
are used to store information that can be in one 
of two states, like doors which are open or shut, 
lights which are on or off, etc. There are three 
which are important for the adventure program : 
Mkr 0, if set, means that a room has been 

described since it was last reset. 
Mkr 1, if set, means you are in a light room. 
Otherwise you are in a dark room. 



Mkr 2, if set, means you have 



lamp 



or 



some 



CTR c 

x EQU? c 



TURN 

ROOM 
AT r 



other source of light, 
If markers 1 and 2 are both reset, then the 
program will refuse to describe rooms, coming up 
with the "It's dark" message instead, since you 
are in a dark room without a lamp. 

Mkr 3, if set, disables the scoring mechanism 
when you exit from the game. 

Gives you the value of counter c. 

Is x equal to the value of counter c ? 

There are 128 counters, numbered from 0 to 127. 

They are most frequently used to store the number 

of moves since a particular event, (e.g. in the 

dark). Counter 0 holds the score and counters 126 

and 127 hold the turns count since the start of 

the game. 

Gives the number of turns since the start of the 
game . 

Gives you the room number of the room you're 
currently in. 

Gives a TRUE answer if you are at room number r. 



condition AND condition will give a TRUE answer 
conditions give TRUE answers, 
e.g. VERB 1 AND NOUN 2 will be TRUE 
and noun 2 are both typed, 
condition OR condition will give TRUE if either 

TRUE, or both, 
condition XOR condition will give TRUE if one of 

is TRUE and the other FALSE. 
NOT condition will give a TRUE answer if the 
FALSE, and vice versa. 
So NOT VERB 1 will be TRUE if verb 
x <= y Gives TRUE if number x is less than 

number y. 
Gives TRUE if x 
Gives TRUE if x 



>= y 
= y 



is greater than 
is equal to y. 



if both of the 

only if verb 1 

condition is 

the conditions 

condition was 

1 is NOT typed, 
or equal to 

or equal to y. 



RAND x 



VBNO 

N01 

N02 



Gives a random number between 0 and (x-1). So 
RAND 10 will give any number at random in the 
range 0 to 9. 

Gets the number of the verb in this command. 
Gets the number of the first noun in this command 
Gets the number of the second noun in this 
command . 

These are used to check word order, and to GET and 
DROP objects without having to have a condition 
for each one. 



ACTION PART 

LOOK 
DESC r 



Describe the room you are in at the moment 
Describe room number r 



PICT 
TEXT 



{These do nothing on the Adventure Creator but are 
{retained for compatabi 1 i ty with GAC. 



GET o 

DROP o 
x SWAP y 



OBJ o 
LIST r 
LIST WITH 
o TO r 



SET n 
RESE m 

x CSET c 
INCR c 
DECR c 



GOTO r 
CONN v 



STRE x 

BRIN o 
FIND o 



Get object number o. If it isn't here, or you've 
already got it, or it's too heavy, then the 
appropriate message is printed. 

Drop object number o. If you haven't got it, then 
the appropriate message is printed out. 
Exchange objects x and y. In our little 
adventure, 1 SWAP 5 will exchange the lamp and the 
lit lamp. 

Describe object number o 

List all the objects in room number r 

Lists all the objects carried with you. 

Hove object number o to room r. To destroy an 

object move it to room 0. 

Set marker m 

Reset marker m. See SET? and RES? for an 
explanation of markers. 

Set x to be the value of counter number c 
Increase counter c by one. The maximum is 255. 
Decrease counter c by one. The minimum is 0. 
Trying to increase past 255 or decrease past 0 is 
ignored. 

Go to room r and describe the new room. 
This checks through the connection table for a 
connection from the current room using verb v. If 
one is found, this gives the room number of the 
room you would move to if you took the connection, 
if not, then it gives zero. As an example, if you 
were in room 3 in our adventure, CONN 4 would give 
2 because in the connections from room 3, verb 4 
(W) would take you to room 2. 

Set the maximum weight you can carry to x. STRE 

is short for STRENGTH. 

Brings object o here, (if it exists) 

Find object o and move to it, (if it exists). 

This does not acknowledge any restrictions, (such 

as connections), so it could be useful in a magic 

spell or something. 



SAVE 
LOAD 



WAIT 
OKAY 
EXIT 

QUIT 



CHN 



Saves the current game position. 
Loads the current game position. 

These are useful for continuing a game after tea 

or after you get killed ! 

Waits for a new command. 

Prints "Okay" and awaits a new command. 

Stops the game. The player is NOT asked, so this 

is for use when the player gets killed or wins. 

The player is asked if he wants to continue, and 

if he types "N" for "NO" when asked if he is sure, 

the game continues, otherwise the game is 

abandoned. 

On abandoning the game, the score and number of 
moves taken is displayed, if not disabled by 
setting marker three. 

Load next part of the adventure from tape. See 
section 2. 12. 



HESS ms 
PRIN x 



Print message number ms. 
Print number x. 



LF Prints a LineFeed. Everything from here is 

printed on a new line. 
WITH Is equal to the room number of where things are 

put when you are carrying them. 
HOLD x Holds up the game for x hundreths of a second. 

For example, to freeze for 10 seconds, do HOLD 

1000. (Or until a key is pressed), 
x + y As you may expect, this returns the value of x 

added to y. 

x - y And this gives the value of x - y. 

There are several things to note when writing conditions. Firstly 
all operations are performed from left to right. The second thing 
to note is that AC requires spaces both inside and outside 
brackets, and also between words such as 'verb' and 'noun' and their 
numbers and finally that Conditions should be entered in Upper Case. 

Thirdly, x and y need not be simply numbers, they can be more 
complex expressions. However you should note that since GAC 
performs all it's operations from left to right, you should be 
careful about the order in which you enter things. Put any 
COMPARISONS first, i.e. IF ( VERB >= 5 AND NOUN 9 ) QUIT END 

The conditions are checked by AC at three different points, 
and are entered as High Priority, Low Priority and Local Conditions. 
See the flow chart at the back of the manual to see the order in 
which these are actioned. 

HIGH PRIORITY conditions are checked for BEFORE the adventure 
prompts for a player command. It checks for such things as whether 
you are still "Alive" ! Whether a light is flashing etc. 

Pressing H on the main menu will get the prompt "Line Number?" 
You should enter a number in order, ie. 1, 2, 3 etc etc. 
AC will not recognise a line number such as '5' when you have only 
entered two conditions so far, although it will insert a condition 
earlier in your list and remember accordingly. 

RETURN will give you the prompt "Line number _ is....", at which 
point you should enter your condition and press RETURN which will 
give you the "Line number" prompt again. 
"ESCAPE" returns you to the main menu. 

LOCAL CONDITIONS are checked for after the player has entered a 
command, they deal with things local to a particular room. For 
example, whether a particular object is in a room or it might 
execute a player command to go to another room, or open a door at 
that location. 

Pressing C on the main menu will give the prompt "Room ' Number? " 
Entering a number followed by RETURN will give the prompt "Line 
number?" Thereafter the procedure is exactly the same as for High 
Priority Conditions, except that each Room has it's own set of line 
numbers, (1, 2, 3 etc). 

LOW PRIORITY CONDITIONS are also checked for after a player 
command is entered, but are not associated with any particular room. 
For example, they might check whether you are carrying a particular 
object, independent of the location. 

After pressing L on the main menu, the procedure for entering and 
editing Low Priority Conditions is exactly the same as that for High 
Priority Conditions. 

Further examples of High, Local and Low Priority Conditions can 
be found in Appendix A. 



(2.8) BEGIN WHERE? 



The last element of your adventure, at least as far as the text is 
concerned is to specify which room your adventure starts in. 

Pressing B on the main menu will give the prompt to enter 
start location number. 



Entering a room number followed by 'Return' means that your 
adventure will start at this room. To change the start room, simply 
enter a new number. 

'Escape' will return you to the main menu. 



(2.9) SAVE AND LOAD 



SAVING 



Pressing S on the main menu, you will be asked if you wish to save a 
"Data File" or a "Runnable Adventure". 

If you press 'D' for 'Data File', it will prompt for a file name. 
Enter your file name followed by 'Return', this will save your Data 
which can be loaded into AC at a later date for further 
development. 

If you press ' R ' for runnable adventure followed by 'RETURN', your 
data will be saved as a Runnable Adventure, which can no longer be 
loaded into AC for editing but will run on its own. 



LOADING 



Pressing T on the main menu followed by a file name will load a 
Data file into AC for editing. 

To play your runnable adventure enter * RUN "FILENAME" 

NOTE : Do not attempt to load a runnable adventure into AC. It will 
run on its own ! 



(2. 10) DELETE DATA 



Pressing X on the main menu will delete all your data. 
N.B. Loading a new data file will have the same effect. 



(2. 11) PRINTER MENU 



Pressing P on the main menu, will give you the Printer Menu. Select 
section for printing by pressing the appropriate key. To print to 
your printer press P at the appropriate prompt, or to print to the 
screen, press S. (The SHIFT key will scroll the screen if 
necessary ) . 

ESCAPE will return you to the main menu. 



(2.12) CREATING MULTI-PART ADVENTURES 



The AC uses extensive text compression which enables commercial 
sized adventures to be written. However, for large adventures AC 
allows multi-part adventures to be created using the 'CHN' command. 

When CHN is executed in a line of conditions the program will 
look for and load a new datafile. The information on the state of 
play is preserved, (i.e. the current room, players strength, weight 
carried, all flag and counter settings and the position of all 
objects, including those being carried). The rest of the condition 
line is ignored, (since it has now been written over), and play 
continues from the start of a new turn. 

The CHN command should be used with caution and the following 
points noted: 

1) The objects are NOT initialised to their start rooms after a 
CHN. Any objects that exist in the second part of the adventure 
that were not in the first part will start off in room 0, (i.e. 
not created). Objects and their matching nouns that you want to 
start in a specific room should be defined in the first part AS 
WELL AS the second. 

2) Going to a room that is not defined in the current module will 
give a "Room not found" error. This can cause problems if a 
player SAVES his or her position whilst in the second part of 
the adventure and later tries to LOAD it into the first part. 
There are two methods of avoiding this: 

a) Giving the player the option of loading the second part 
before loading his position, (perhaps by giving him a password). 

b) If, for example, the first part consists of rooms 1-100 and 
the second of rooms 100-200, then a HIGH priority condition in 
the first part of; IF ( ROOM >= 100 ) CHN END will automatically 
chain the second part of the adventure when a game position is 
loaded. 



To create a runnable multi-part adventure, save the first part with 
the R (runnable ) option and the following part(s),with the D (data) 
options consecutively on tape. 

EXAMPLE: A two-part adventure consists of rooms 1-100 in the first 
part and rooms 100-200 in the second. Room 100 is common to both 
parts and is used to link the two sections. 

DATA FOR FIRST SECTION 
Room 100: 

As you step onto the pentagram, the Wizard says "You have done well, 
but far greater perils await before you complete your quest." Your 

surroundings fade to be replaced by a strange alien landscape 

CONNECTIONS none 

MESSAGE 99: Loading next section. Insert tape and press PLAY. 
HIGH PRIORITY CONDITIONS: IF ( ROOM >= 100 ) MESS 99 CHN END 

DATA FOR SECOND SECTION 

Room 100: You are on an open plain of black crystal. The sunless sky 
is of constantly shifting colours. The crystal throbs gently beneath 
you. 

CONNECTIONS E102 W105 

The loading message and condition line. are not needed in section 2, 
(unless a third section is to be chained). 

In the above example, when the player reaches room 100 in the first 
section the room description is followed by the loading message. 
When the second section has loaded the new description is printed. 



(3.1) SECTION THREE - TEST ADVENTURE 



To test your adventure, get back to the main menu and simply press 
"RETURN " to enter the adventure. 

When you are testing an adventure, the way to return to the main 
menu is to press ESCAPE as usual. This gives you the message "Press 
D for diagnostics or "ESC" to ESCAPE...". If you press the "D " key, 
then all the markers and counters will be displayed on the screen. 
For the markers, a one indicates "SET" and a zero indicates "RESET". 
The values of the counters are given as you would expect. To get 
back to the game press escape. 

If you press any other key again then you will get back to the main 
menu. 

The error routine prints out a message indicating the nature of 
the error, plus a line of conditions if the error occurred in one of 
the condition tables. 

Message not found means you have referred to a message that 

does not exist. If you get this immediately, check that you have 
entered the system's special messages at numbers 240 and above. 

Room not found means you have tried to describe, or move 

to, a room that doesn't exist. 

Object not found means you have tried to pick up, drop, or 

describe an object that' does not exist. 

Marker not found means you have tried to access a marker 

which does not exist. 

Counter not found means you have tried to access a counter 

which does not exist. 

Illegal value means you have tried to look for a verb, 

noun, or adverb with a number greater than 255, or you have tried to 
load a counter with a number greater than 255. 

Here are a few hints for solving errors : 

i. Suspect typing error. Check that you really mean what you 
have said. 

ii. Have you forgotten to enter the room/object/message being 
referred to? If so enter it. 

iii. Have you forgotten to delete this condition which you didn't 
need, having deleted the objects/messages used by it? 



(3.2) PLAYER COMMANDS 



This section looks at the commands a player gives when he plays the 
adventure. It is intended to give an idea of the complexity of the 
commands the adventure will understand. 

Each command line consists of one or more simple commands, 
which in turn consist of a verb, and maybe an adverb and one or two 
nouns. Any word which the command interpreter does not understand 
as being a noun, verb or adverb is ignored. 

Let us take a typical line and see how the program looks at 

it. 

Get the gold, examine it, put it in the box then go north 

Let us assume that the vocabulary includes : 

NOUNS ! 3 GOLD VERBS I 1 NORTH ADVERBS : 1 IN 

7 BOX 7 GET 

255 IT 8 PUT 16 EXAMINE 

The command line is split into separate commands by the 
following : ".", "," "!", "?", " : " , ";", "and" and "then", so it 
becomes : 

Get the gold 
Examine it " , " 

Put it in the box "then" 
Go north 

Each of these is scanned for verbs, adverbs and nouns in that order, 
and any found have their number stored. 

VERB ADVE NOUN 1 N0UN2 

Get the gold 7 0 3 0 

Examine it 16 0 255 0 

Put it in the box 8 1 255 7 

Go north 10 0 0 



Then all occurences of noun 255 ("It"), are 
noun typed before that, giving 



replaced by the last 



VERB ADVE NOUN 1 

Get the gold 7 0 3 

Examine it 16 0 3 

Put it in the box 8 1 3 

Go north 1 0 0 



N0UN2 
0 
0 
7 
0 



These values are then passed to the connection table, and then to 
the conditions. See diagram in Appendix B. 

Note that all the letters in the vocabulary entries are significant 
- there is no truncation to only four or five letters. Thus RIVER 
and RIVET, TROUT and TROUSERS, and others like these are 
distinguished between. 



APPENDIX A 



Definitions and Conditions for " ADVMAN " 



i . NOUNS 

1 TORCH 

1 LAMP 

2 RAT 
KEY 
GOLD 
BAR 

TREASURE 
SNAKE 



. VERBS 



5 SERPENT 

6 DOOR 
255 IT 



NORTH 
SOUTH 
EAST 
WEST 
UP 

6 DOWN 

7 GET 

7 TAKE 

8 DROP 



9 LOOK 

10 LIST 

10 INVENTORY 

11 QUIT 

14 SAVE 

15 LOAD 

15 RESTORE 

16 EXAMINE 

17 LIGHT 



17 ON 

18 EXTINGUISH 

18 OFF 

19 UNLOCK 

20 SCORE 

21 EAT 



1 N 



2 S 3 E 



4 W 



5 U 6 D 



iii. ROOM DESCRIPTION 

Room No. Description (as it would appear) 



1. 
2. 
3. 
4. 
5. 

6. 



There is a 



You are above the ground, 
cave entrance to the east. 
You are in a large cavern. Passages 
lead east, west and south. 
You are in a cave. A snake is asleep 
in a corner and exits lead east and west. 
You are by a small lake. The only exit 
is west. 

You are outside a castle. A tunnel leads 
to the north and a large door can be seen 
to the east. 

You are in the castle strongroom. A door 
stands open to the west. 



Connect ions 
(press RETURN) 

E 3 

W 3 

(press RETURN) 
(press RETURN) 

W 5 



iv. OBJECTS 

No. Description 



1. 
2. 
3. 
4. 

5. 



a lamp 

a dead rat 

a key 

a gold bar 
a lit lamp 



Starts in room Weight 

1 10 

5 20 
4 1 

6 100 

0 ioo 



v. MESSAGES 



238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 



nothing 

You are carrying 
What now ?. . . . 
You can't 
Pardon ? 

Press a key for another game.... 
Are you sure ( Y or N ) ? 
You've already got that. 
You haven't got that. 
You can't see that. 

You're carrying too much to pick that up. 



249 Your score was 

250 and you took 

251 It's dark. You can't see a thing. 

252 I can't find that anywhere. 

253 You can also see 

254 Okay 

255 turns 

i. Conditions - Local Don't type in the comments ! 



Room 1 

IF ( VERB 3 ) RESE 1 GOTO 2 WAIT END 

If you typed "EAST", reset the dark/light marker, goto room 2 
and wait for a new command. 
Room 2 

IF ( VERB 4 ) SET 1 GOTO 1 WAIT END 

If you typed "WEST", set the dark/light marker, goto room 1 and 

wait for a new command. 
IF ( VERB 2 ) SET 1 GOTO 5 WAIT END 

And a similar condition for going south too. 
Room 3 

IF ( VERB 7 AND NOUN 5 ) MESS 14 HOLD 200 EXIT END 

If you typed "GET SNAKE" then print message fourteen to say 
how it reacts, freeze for four seconds and end the game. 

IF ( VERB 3 ) SET 1 GOTO 4 WAIT END 

Again another move-f rom-dark-room-to-1 ight-room condition, this 
time east. 
Room 4 

IF ( VERB 4 ) RESE 1 GOTO 3 WAIT END 

I'll let you work this one out (hint - look at rooms 1, 2, 3) 
IF ( VERB 7 AND NOUN 3 ) CTR 0+20 CSET 0 END 

If you typed "GET KEY" then add twenty to counter 0 (the score) 
IF ( VERB 8 AND NOUN 3 ) CTR 0-20 CSET 0 END 

If you typed "DROP KEY" then subtract 20 from ctr 0 (the score) 
Room 5 

IF ( VERB 3 AND SET? 3 ) GOTO 6 WAIT END 

If you typed "EAST" and marker 3 is set, (i.e. if the door has 
been opened), goto room 6 and wait for a new command. 

IF ( VERB 3 ) MESS 7 WAIT END 

If you typed "EAST" then print message 7 and wait for a new 
command. Note that the door cannot be opened since if it was, 
the last line would have worked and we would be waiting for a 
new command by now. 

IF ( VERB 19 AND NOUN 6 AND CARR 3 ) SET 3 MESS 10 WAIT END 

If you typed "UNLOCK DOOR" then set marker 3, (mark the door as 
open), print message 10 and wait for a new command. 

IF ( VERB 1 ) RESE 1 GOTO 2 WAIT END 

It is another light-to-dark movement, this time north to room 2 

ii. Conditions - Low Priority 

Those marked "*" are included in the Quickstart file. 

IF ( VERB 20 ) MESS 249 PRIN CTR 0 MESS 250 PRIN TURN MESS 255 
WAIT END 

If you typed "SCORE", print message 249, your score, message 
250, the number of turns you had and message 255. Then wait 
for a new command. 
IF ( N01 = 0 AND VERB 7 ) MESS 19 WAIT END 

If you typed "GET" by itself or with an unrecognized word, 
print message 19 "I'm sorry, but I don't know what one of those 
is.. . " 



IF ( N01 = 0 AND VERB 8 ) MESS 19 WAIT END 

And similarly for "DROP" . 
IF ( NOl = 0 AND VERB 16 ) HESS 18 WAIT END 

And again for "EXAMINE" . 
IF ( VERB 7 AND NOUN 1 AND HERE 5 ) GET 5 OKAY END 

If you typed "GET LAMP" and there is a lit lamp here, then get 

it, print "OKAY" and wait for a new command. 
IF ( NO 1 <=5 AND VERB 7 ) GET NOl OKAY END 

If you typed "GET" and a noun with a number less than 5, then 

get the object with that noun's number. This only works 

because the objects and the nouns which refer to them have the 

same number. (A very. useful trick!) 
IF ( VERB 8 AND NOUN 1 AND CARR 5 ) DROP 5 OKAY END 

If you typed "DROP LAMP" and you've got a lit lamp, then drop 

it, print "Okay" and wait for a new command. 
IF C NOl <= 5 AND VERB 8 ) DROP NOl OKAY END 

If you typed "DROP" and a noun whose number is less than 5, 

then drop the object with that noun number. 
IF ( VERB 16 AND NOUN 1 AND AVAI 5 ) MESS 5 WAIT END 

If you typed "EXAMINE LAMP" and you have a lit lamp available 

then print out its more detailed description and wait for a new 

command . 

IF ( NOl <= 5 AND VERB 16 AND AVAI NOl ) MESS NOl WAIT END 

If you typed "EXAMINE" and a noun whose number is less than 5, 
then print out the message with that noun number, it being the 
more detailed description of that object, then wait for a new 
command. 

* IF ( VERB 11 ) QUIT END 

If you typed "QUIT" then quit. 

* IF ( VERB 9 ) LOOK WAIT END 

If you typed "LOOK" then describe this room and wait for a new 
command. 

IF ( VERB 21 AND NOUN 2 AND CARR 2 ) DROP 2 2 TO 0 MESS 17 WAIT 
END 

If you typed "EAT RAT" and you are carrying it, drop it, move 
to room 0, thus destroying it, print message 17 ("yum, yum") 
and wait for a new command. 

* IF ( VERB 10 ) MESS 239 LIST WITH END 

If you typed "INVENTORY" then list the objects with you and 
wait for a new command. 

* IF ( VERB 13 ) PICT OKAY END 

If you typed "PICTURES" then turn them on, print "OKAY" and 
wait for a new command. 

* IF ( VERB 12 ) TEXT OKAY END 

And similarly for "TEXT". 

IF ( VERB 17 AND NOUN 1 AND AVAI 1 ) 1 SWAP 5 CTR 0+20 CSET 0 

MESS 15 SET 2 WAIT END 

Type this all on one line. If you typed "LIGHT LAMP" and you 
have an unlit lamp, then exchange the lit lamp for the unlit 
one, tell the user that he has lit the lamp, increase the score 
by 20 and await a new command. 

IF ( VERB 18 AND NOUN 1 AND AVAI 5 ) 1 SWAP 5 CTR 0-20 CSET 0 

MESS 16 WAIT END 

And similarly for "LAMP OFF" ("EXTINGUISH LAMP"). 

* IF ( VERB 14 ) SAVE OKAY END 

If you typed "SAVE" then save the game position. 

* IF ( VERB 15 ) LOAD LOOK WAIT END 

If you typed "LOAD" then load in a previously saved game 
pos i t ion . 



iii^Conditions^- High Priority 



''if 5U 6 T rltl^Vi 3 CSET 1 END 

aarKer 8 to {*' *■ g* "«* .ove. then 3e t 

If you are in total darlcnp*?* j 
IF C 1 EQU? i AND RES? 1 AND RES? 1 ) HESS^O SSS"*** ° De - 

> t"ef p*? n f? hat you can hear 

IF ( 0 EQU? 1 ) HESS 21 EXIT END 

J ot°y^ SRE-S *" » "as bee „ 

SA end* AND RES? 4 AND CARR 2 ' sftTmess W DROP 2 2 to o 

i£ ? - r - awns %~jrjBftA-2 

IF < AT 1 AND CARR 4 ) HESS 9 EXIT END 

If you are back at the start carrying the c*>ia -u 

' "'"8 t" e gold then you uin ! 



GET AND DROP 



Here is another useful feature! To save „„♦♦,„ 

condition in for each and every ob%« 8 * * and Drop 

condition lines that will enable yo^to S2* ?*T tU ° very usef "l 
to No. 10 in our example) 8 ~ nd drop an * object, (up 

the Noun nu B bers Mate! ! the Object numbers": thiS ***** ens "' 

NOUN 1 = Hat OBJECT 1 = a hat 

and enter Lou Priority Condition lines : 



IF ( NO 1 < = 10 AND VERB 7 ) GET NOl OKAY FMn 
IF ( NOl < = 10 AND VERB 8 , DROP NO 1 OKAY END 



APPENDIX B 



Tables and Charts 



THE QUICKSTART DATA FILE 



The "Quicks-tart " data file contains all the system messages, many 
useful verbs, and several of the common low priority conditions 
associated with them. This is to allow you to get straight in to 
writing the adventure that you want to write, without having to 
worry about things that are included in all adventures. 
The full contents are : 



VERBS 


NOUNS 


255 IT 


6 


D 






6 


DOWN 


MESSAGES 


8 


DROP 






3 


E 


238 


noth ing 


3 


EAST 


239 


You are carrying 


16 


EXAMINE 


240 


What now ?. . . . 


7 


GET 


241 


You can't. 






242 


Pardon ? 


10 


INVENTORY 


243 


Press a key for another game. . . 


9 


L 


244 


Are you sure ? (Y/N)... 


10 


LIST 


245 


You've already got that. 


15 


LOAD 


246 


You haven't got that. 


9 


LOOK 


247 


You can't see that. 


1 


N 


248 


You're carrying too much to pick 


1 


NORTH 




up. 






249 


Your score was 


11 


QUIT 


250 


and you took 


15 


RESTORE 


251 


It is dark. You can't see. 


2 


S 


252 


I can't find that anywhere. 


14 


SAVE 


253 


You can also see 


2 


SOUTH 


254 


Okay 


7 


TAKE 


255 


turns 


5 


U 






5 


UP 






4 


W 






4 


WEST 







LOW PRIORITY CONDITIONS 



IF ( VERB 9 ) LOOK WAIT END 

If you typed "LOOK", redescribe the room you're in and wait for a 

new command. 
IF ( VERB 10 ) MESS 239 LIST WITH WAIT END 

If you typed "INVENTORY" then print "You are carrying" and list 

all the objects that are with you. 
IF ( VERB 11 ) QUIT OKAY END 

If you typed "QUIT" then ask the adventurer if he is sure, and if 

he responds Y (for YES) then quit, otherwise print OKAY and wait 

for a new command. 
IF ( VERB 14 ) SAVE OKAY END 

If you typed "SAVE" then save the game position. 
IF ( VERB 15 ) LOAD LOOK WAIT END 

If you typed "LOAD" then load a previously saved game position 

and describe the room you are in. 



ii. SUBSCRIPTS USED WITH CONDITION WORDS 



a - 


ad VP r K num'koT- 
a. u. v c i O IlUllllDer 


c — 


ouunter number 


m — 


ffl ^ r L - o r n ii ■ Vam 

w<xi ner number 


ms 


message number 


o 


object number 


n 


noun number 


r 


room number 


v - 


verb number 


*»y - 


any numbers 



iii. WORDS USED IN CONDITIONS 



Words 


Markers Counters Rooms 




Commands 


VERB v 


SET m CSET 


C GOTO 


r 


OKAY 


NUUN n 


RESE m INCR 


C CONN 


r 


WAIT 


ADVE a 


SET? m DECR 


C ROOM 




EXIT 


N01 


RES? m CTR 


c AT 


r 


QUIT 


N02 


x EQU? 


C DESC 


r 




VBNO 


TURN 


LOOK 






Objects 


Decisions Tape 






GET o 


OBJ o IF 


SAVE 






DROP o 


LIST o END 


LOAD 






o SWAP o 


WEIG o 








HERE o 


STRE o 








CARR o 


o TO r 








AVAI o 


BRIN o 








r IN o 


FIND o 








Other 










MESS ms 




x = y 






x + y 




WITH 






x - y 




RAND x 






cond i t i on 


AND condition 


PRIN x 






condi t ion 


OR condition 


HOLD x 






condi t i on 


XOR condition 


LF 






nut condition 

X >= V 


CHN 







X >= y 
X <= y 

m< COUNTERS AND MARKERS USED BY THE SYSTEM 



Counter 0 - Holds the score 

126 x 1 } Count the number of turns sine? th e Vs^,« • 

127 x 256 } of the game. the be S innin S 

Marker 0 - ^et^means that a room has been described since 

1 - If set, you are in a light room. 

2 If set, you have a source of light 

3 - If set, disables the scoring mechanism. 



v. RANGES OF NUMBERS 

No. allowed 



Rooms 


1 . 


. 9999 


Objects 


1. 


.255 


Messages 


1. 


.255 


Verbs 


1, 


.255 


Nouns 


1. 


.255 


Adverbs 


1. 


.255 


Markers 


0. 


.255 


Counters 


0. 


. 127 


CWhich store] 


0. 


.255 



No. of characters 

255 

255 

255 

35 

35 

35 



START 

output 
ROOM DESCRIPTION 



IE 



TURNS + 1 



HIGH PRIORITY 
CONDITIONS 



240 : "What now?" 



241 : "You can't' 

242 : "Pardon?" 



/ output 7 
/ MESSAGE 240/ 

/ PLAYER'S INPUT/ 



CHECK CONNECTION 
TABLE 




LOW PRIORITY 
CONDITIONS 



VERB = 0? 



I 



/MESS 241 / 

< 1 — <r- 



/MESS 242 / 



The internal commands QUIT and EXIT return the player to the f 
room with the program initialized. There is no end as such. 
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